Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / dosplus.arc / DOSPLUS.DOC < prev

Wrap

Text File | 1987-05-27 | 21.9 KB | 590 lines

DOSPLUS : Resident DOS Utilities Version 1.03, 27-May-1987 SMG Software (C) Copyright 1987 by Steven Georgiades All Rights Reserved This program allows the user to add 9 new resident commands to DOS, under the CED command editor, version 1.01 (Copyright 1985, Christopher J. Dunford). CED is a public domain program that is available from most major bulletin boards, including the Circuit Board (714-778-0948). For more information on CED, see Appendix A, below. DOSPlus occupies about 4 Kbytes of memory when made resident, and takes up 101 bytes of CED's user command stack. A detailed description of each of the DOSPlus commands is given in Appendix B, but here is a brief summary: BEEP BEEP [/Fn][/Dn][/Rn][/Wn][;... Enhanced Speaker Output CLS CLS [page] Clear Screen DHELP DHELP DOSPlus Help Message DVER DVER DOSPlus Version Number ECHOF ECHOF [string] Formatted Echo FREE FREE Memory Status Report PAGE PAGE n Change Active Page PICK PICK [{prefix}] mask [suffix] Pick File Matching Mask SPACE SPACE [d:] Disk Status Report Each of these commands can be entered not only at the DOS prompt, but also within some applications programs, including EDLIN and DEBUG, and any other program in which the CED editing keys and synonyms work. This is why the CLS command is duplicated in DOSPlus, when it is already available under DOS. Note that these commands are NOT available as resident commands from within a batch file. For this reason, non-resident versions of all of these commands are included in this package. DOSPLUS, Version 1.03 Page 2 Command Format: DOSPLUS [-I | -U] -I = Install DOSPlus. If not yet resident, will load DOSPlus in memory and make it resident. If already resident, will re-install the DOSPlus commands, taking up more CED user command space, but taking up no more system memory. This is intended to be used to reverse the -U option, see below. -U = Un-Install DOSPlus. This option will only work if DOSPlus is already resident in memory. This option will NOT free the system memory that the resident portion of DOSPlus occupies. What it does do is un- install the DOSPlus resident commands, freeing up CED user command space. This option is provided in case the DOSPlus commands interfere with other software. Before running the problem software, enter "DOSPLUS -U" to remove the DOSPlus commands. After you are finished, enter "DOSPLUS -I" to be able to use the DOSPlus commands again. These commands could be included in a batch file for convenience. Examples: DOSPLUS (Print DOSPlus usage message) DOSPLUS -I (Make DOSPlus memory resident. If already memory resident, re-install the DOSPlus commands) DOSPLUS -U (Un-install the DOSPlus commands) Revision History: Version 1.00 Pre-release version. Version 1.01 Initial Release. Version 1.02 Fixed a few minor bugs. Version 1.03 Fixed minor bug in FREE command. DOSPLUS, Version 1.03 Page 3 This software is distributed as ShareWare. "ShareWare" means that you are granted free license to use and copy this software as much as you like, within the following restrictions: 1). It is distributed in its original, unmodified form, including program and documentation. 2). No fee is charged for use, copying or distribution (With the exception of nominal "per disk" copying charges, not to exceed $6.00 per disk). 3). The program may not be included with other goods or services supplied for a fee, unless written permission to do so is obtained in advance from the author. No registration fee is required for DOSPlus, but if you find the program valuable, a contribution in any amount would be GREATLY appreciated, and would help to ensure that more quality software will be produced. Minor program customization can be performed on an individual basis, for a nominal fee of $20. The fee for major customization is negotiable, but in most cases will not exceed $50. With every contribution of $15 or more, I will send a diskette containing the latest version of the software (unless you currently have the latest version, in which case I will send you the next major revision), a printed version of the documentation (8-1/2 x 11, unless you specify 5-1/2 x 8-1/2), and basic user support, which means that I will work with you to resolve problems and bugs. With a contribution of $25 or more, I will also perform any minor customization of the program that you may desire (if you are unhappy with a command format, I will change it for you, etc.). For a contribution of $50 or more, I will do some major customization (adding commands, etc.), will send you all major revisions for a period of two years, and I will provide telephone support to help you resolve problems. DOSPLUS, Version 1.03 Page 4 This program is provided AS IS without any warranty, expressed or implied, including but not limited to fitfulness for a particular purpose. If you have any questions or comments about this or any other SMG program, or if you would like to register any SMG Software, write to me at the following address: Steven M. Georgiades SMG Software 701-H South Hayward Street Anaheim, CA 92804 Or leave a message for me on the Circuit Board: The Circuit Board RBBS SYSOP: Dave Kleinschmidt (714) 778-0948 300/1200/2400 Baud - No Fee All SMG Software is initially released to the public through the Circuit Board. The latest version of any SMG Software can always be found there. A diskette containing all of the latest SMG Software can be obtained by sending a check or money order for $6.00 to the above address. DOSPLUS, Version 1.03 Page 5 APPENDIX A : The CED Command Editor The CED command editor is NOT a product of SMG Software. It was written by Christopher J. Dunford, and he hold the copyright to it. The program has been placed in the public domain, and may therefore be freely copied and distributed. For more information on CED copyrights, and commercial use of CED, see the CED documentation. The CED Command Editor is: Copyright (c) 1985 by Christopher J. Dunford 10057-2 Windstream Drive Columbia, Maryland 21044 CompuServe ID 76703,2002 CED is a program that provides the following functions at the DOS prompt, or from within certain applications programs: -- Complete command line editing facility. -- Recall of previously issued commands for re-entry. -- Command synonyms, which may include "chaining" of a series of commands. -- Parameterization of synonym commands. -- Recall of parameters for previously issued commands. -- User-settable buffer sizes for all functions. -- For programmers, a facility to add new "resident" commands to the DOS shell (this is what DOSPlus is). For further information on the use of CED, please refer to the CED documentation. DOSPLUS, Version 1.03 Page 6 APPENDIX B : The DOSPlus Commands The DOSPlus commands are summarized below, and are described in detail in the following pages. BEEP BEEP [/Fn][/Dn][/Rn][/Wn][;... Enhanced Speaker Output CLS CLS [page] Clear Screen DHELP DHELP DOSPlus Help Message DVER DVER DOSPlus Version Number ECHOF ECHOF [string] Formatted Echo FREE FREE System Free Memory PAGE PAGE n Change Active Page PICK PICK [{prefix}] mask [suffix] Pick File Matching Mask SPACE SPACE [d:] Disk Free Space DOSPLUS, Version 1.03 Page 7 BEEP Command _____________________________________________________________ Purpose: Produce audio output from the system's speaker. Format: BEEP [/Fn][/Dn][/Rn][/Wn][;[/Fn]...] Type: Internal External (***) (***) Remarks: The specified tone or tones are sounded from the system's speaker. A single tone may be output, multiple identical tones, or multiple unique tones. The /F parameter provides the ability to specify the frequency of the output tone. The value must be specified in Hertz and must be in the range of 19 to 65535. If this parameter is omitted, a default of 896 Hz is used, which matches the standard PC bell (Control-G). The /D parameter provides the ability to specify the duration of the output tone. The value must be specified in 1/18's of a second and must be in the range of 1 to 65535. If this parameter is omitted, a default of 9 is used, which matches the standard PC bell (Control-G). The /R parameter provides the ability to specify the number of repititions of the tone to output. The value must be an integer from 1 to 65535. If this parameter is omitted, a default of 1 is used. The /W parameter provides the ability to specify the duration of the silence between output tones. The value must be specified in 1/18's of a second and must be in the range of 0 to 65535. If this parameter is omitted, a default of 0 is used. Example: The following example outputs a single tone of 896 Hz for 1/2 second (the standard PC bell): A>beep The following example outputs a single tone of 2000 Hz for 2/18 second: A>beep /f2000/d2 The following example outputs three tones, one at 1000 Hz for 3/18 second, the next two at 2000 Hz for 4/18 second, with 7/18 second of silence between them: A>beep /f1000/d3/w7;/f2000/d4/r2 DOSPLUS, Version 1.03 Page 8 CLS (Clear Screen) Command _____________________________________________________________ Purpose: Clears the specified page of video memory. Format: CLS [page] Type: Internal External (***) (***) Remarks: This command clears the specified page of video memory. If no page number is specified, the current active display page is cleared. Examples: The following example clears the current active display page: A>cls The following example clears page 3 of video memory: A>cls 3 DOSPLUS, Version 1.03 Page 9 DHELP (DOSPlus Help) Command _____________________________________________________________ Purpose: Gives a brief summary of all of the DOSPlus commands. Format: DHELP Type: Internal External (***) (***) Remarks: This command will print a brief summary of all of the DOSPlus commands to the standard output device. The output from this command can NOT be redirected or piped (using the DOS special characters, '>', '>>' or '|'), but can be printed using Ctrl-PrtSc. Example: The following example displays DOSPlus help: A>dhelp DOSPLUS, Version 1.03 Page 10 DVER (DOSPlus Version) Command _____________________________________________________________ Purpose: Displays the DOSPlus version number and copyright notice on the standard output device. Format: DVER Type: Internal External (***) (***) Remarks: The DOSPlus version number consists of a single- digit major version number, followed by a decimal point and a two-digit minor version number. Example: The following example displays the current DOSPlus version number: A>dver The result is: DOSPlus Utilities, Version 1.03 SMG Software Copyright 1987 Steven Georgiades DOSPLUS, Version 1.03 Page 11 ECHOF (Formatted Echo) Command _____________________________________________________________ Purpose: Sends the command line argument to the standard output device, after processing special formatting characters. Format: ECHOF string Type: Internal External (***) (***) Remarks: The special formatting characters that are translated by ECHOF are as follows: \B or \b Output a Backspace Character \D or \d Output a Delete Character \E or \e Output an Escape Character \G or \g Output a Bell Character (Ctrl-G) \L or \l Output a Line Feed \N or \n Output a Carriage Return & Line Feed \R or \r Output a Carriage Return \T or \t Output a Tab Character Example: The following example outputs a formatted message: A>echof Hello!!\g\lHow are you?\l\b\bOK\n\n The result is: Hello!! How are you? OK A> DOSPLUS, Version 1.03 Page 12 FREE (Free Memory) Command _____________________________________________________________ Purpose: Produces a memory status report. Format: FREE Type: Internal External (***) (***) Remarks: This command will produce a memory status report, which includes the total normal memory installed in the system, as well as the portion of that memory that is available for use by applications programs. On systems that have an expanded memory board installed that conforms to the Lotus/Intel/ Microsoft EMS spec, that memory will also be reported. In addition, if you are running on an AT or compatible and have extended memory installed (above the 1 Mbyte boundary), that will also be reported. Example: The following example prints a memory status report: A>free The result is (for my system): 655360 Bytes Total Memory 204448 Bytes Available Memory (31.19%) DOSPLUS, Version 1.03 Page 13 PAGE (Change Active Display Page) Command _____________________________________________________________ Purpose: Changes the current active display page. Format: PAGE [page] Type: Internal External (***) (***) Remarks: This command will change the current active display page to the page specified. If the page number is omitted, this command will respond by reporting what the current active display page is. Example: The following example makes video page 0 the active display page: A>page 0 The following example will tell which display page is currently active: A>page The result is: Page 0 is currently active DOSPLUS, Version 1.03 Page 14 PICK (Select File Matching Mask) Command _____________________________________________________________ Purpose: Picks a file from those matching the filemask. Format: PICK [{prefix}] filemask [suffix] Type: Internal External (***) (***) Remarks: This command will search for all files matching the specified filemask, and will allow the user to interactively select from among them, using the UP and DOWN cursor keys. Once a file has been selected, a command line is constructed by assembling the prefix (if any), followed by a single space character, then the selected filename. If a suffix was specified, a single space character will be appended, followed by the suffix. If the the filemask matches no files, then the filemask is used as the filename (this is to allow the creation of new files). If the filemask matches only one file, then the user is given no choice, and the one matching filename is used. The filemask may optionally include a drive letter and/or a path, and may include wildcard characters ('?' and '*'). Example: The following example allows the user to select for line-editing any file in the current directory of the current drive with an extension of ".DOC": A>pick {edlin} *.doc Assuming the user selected the file "GAMES.DOC", the resulting command line will be: edlin GAMES.DOC The following example allows the user to select for debugging any file in the "SYS" directory of drive A: with an extension of ".COM". The parameter "49" will be appended to the resulting command line: A>pick {debug} a:\sys\*.com 49 Assuming the user selected the file "SDIR.COM", the resulting command line will be: debug a:\sys\SDIR.COM 49 DOSPLUS, Version 1.03 Page 15 SPACE (Disk Status Report) Command _____________________________________________________________ Purpose: Produces a disk status report. Format: SPACE [d:] Type: Internal External (***) (***) Remarks: This command will produce a disk status report, which includes the total amount of disk space on the specified disk, as well as the portion of that space that is not currently in use. Example: The following example prints a disk status report for the current default drive: A>space 362496 Bytes Total Disk Space on Drive A: 60416 Bytes Available (16.66%) The following example prints a disk status report for drive B: A>space b: The result is: 362496 Bytes Total Disk Space on Drive B: 362496 Bytes Available (100.0%)